home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / CDTV / cdtvtools-11 / keeper / keeper.readme < prev    next >
Encoding:
Text File  |  1991-06-24  |  3.1 KB  |  54 lines
  1.  
  2.     Keeper -- written by Ray Lambert for Theta Systems, Inc.
  3.  
  4.     Copyright 1991 Commodore Business Machines, Inc.
  5.  
  6.     Purpose and Usage:
  7.  
  8.         Keeper is meant for use in a startup-sequence file to display a
  9.     picture while booting.  Some applications are quite large and take a
  10.     significant period of time to load.  Unless special steps are taken,
  11.     an application such as this cannot display anything for the user to look
  12.     at until the executable file is completely loaded.  This keeps the user
  13.     waiting and the inactivity makes the load time seem even longer.  This
  14.     practice is not acceptable for a platform such as CDTV where the task of
  15.     keeping the user's attention and preventing the user from becoming bored
  16.     is considered paramount.  Keeper was written to provide a solution to
  17.     this problem.  Keeper should be invoked from your startup-sequence file
  18.     (in the foreground: do not use RUN) with the name of an IFF.ILBM picture
  19.     to be displayed.  Keeper loads the picture and then spawns off a tiny
  20.     task which displays the picture and frees all the resources that are used
  21.     to do so when it is time to remove the picture.  Keeper quits shortly
  22.     after these things are done allowing the remainder of the startup-sequence
  23.     to be executed.  Because keeper runs in the foreground while it is loading
  24.     the picture, there will not be a problem with two processes trying to read
  25.     from the same disk at once (this would slow the boot process considerably).
  26.     Note that this can still occur however if a program gets run in the
  27.     background before keeper is run, and that program reads from the disk
  28.     (this should be avoided).  There are three ways to make keeper remove its
  29.     picture.  First, if keeper is run a second time with the keyword 'QUIT' on
  30.     its command line, keeper will cause a previous copy of itself to terminate.
  31.     Second (and easier), the simple act of loading another View will cause
  32.     keeper to terminate.  Keeper accomplishes this by periodically checking
  33.     the GfxBase->ActiView variable to see if its View has been replaced.  Note
  34.     that because of this it is dangerous for a program to save the active
  35.     View during initialization and then try to restore it later.  Please use
  36.     CloseWorkBench() and OpenWorkBench() instead if possible.  A third method
  37.     of terminating keeper is by Signal()'ing it directly.  Keeper's task can
  38.     be located like this:
  39.  
  40.                        task = FindTask("PicKeeper");
  41.  
  42.     and terminated like this:
  43.  
  44.                        Signal(task,SIGBREAKF_CTRL_C);
  45.  
  46.     Keeper can display any IFF picture including overscan.  Keeper
  47.     automatically compensates for PAL by centering its View appropriately.
  48.     Keeper CANNOT display pictures that require custom copper list code such
  49.     as Dynamic HAM pics.  Keeper reads the CDTV preferences and uses the saved
  50.     screen centering information found there.  If the preferences have not
  51.     been set or are not available (not running on a baby) the centering data
  52.     gets stolen from Intuition's View (actually it is the active View at the
  53.     time keeper runs).
  54.